[Top] [Prev] [Next] [Bottom] [Contents]

SaRegisterFuncSite

Registers a data site callback where a function will be called when the data site is encountered in the HTML template.

Synopsis

#include "SaRnHtml.h"
typedef void (*SaSiteCallback)(char* file, 
					char* site, 
					void* client);
int SaRegisterFuncSite(char* file, 
					char* site, 
					SaSiteCallback func, 
					void* client);

Arguments

file
A string specifying the filepath name of an HTML template file. If non-null and not an empty string, this file will be "played", if it is not already on the "play" list. If NULL or an empty string, the site will still be registered, but can be overridden by a similar site name with a specified filename.
site
A string specifying the site name to register the site function callback on.
func
A site callback function which must be of the type, SaSiteCallback, as declared above.
client
A general purpose pointer that is sent to the callback function. Must be valid when function is called.

Return Values

Returns 1 if successful. Returns 0 if the argument, site, is NULL or an empty string.

Description

Registers a data site callback where a function will be called when the data site is encountered in the HTML template.

Example

typedef void (*SaSiteCallback)(char* file, char* site,
	void* client);
extern SaSiteCallback MySiteCallback;
SaRegisterFuncSite(NULL, "AUTHOR", MySiteCallback, 
	(void*)"Harry Costa");

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.